home *** CD-ROM | disk | FTP | other *** search
- MSYST
- A User Terminal Program
- For use with TNC's or Modems
- By WA8BXN
-
- (C) Copyright 1993 Hub Computers, Inc.
-
-
- This program and documentation is shareware. If you find it useful please
- send $5 (or more!) to support further development of this program and the
- MSYS BBS system. Distribution of this program will be through electronic
- means (the Cleveland Hamnet telephone BBS, for example). You may also
- provide copies of the program and this documentation file to other
- amateur radio operators interested in using it provided no changes are
- made to this documentation file nor the program. Make out your check to and
- send to:
- Michael Pechura
- 10809 Beechwood Drive
- Chesterland, OH 44026
-
- Introduction
- ------------
-
- This program was written primarily to allow use of the YAPP protocol
- provided by MSYS for file (binary or ASCII) uploading and downloading
- using either modem or tnc. It includes additional functions that make
- it usable as a simple terminal program for general use. It can be used
- with most TNC's that can be used with a terminal emulator program as
- well as most modems. Basic features include
- * YAPP protocol support
- * ASCII file capture
- * ASCII file transmission
- * 800 line scroll back buffer
- * DOS Shell to run other programs without exiting MSYST
- * Interrupt driven serial I/O with 16,000 byte input buffer
- * Support for serial ports at any address and Int 0-7
-
- Installation
- ------------
-
- MSYST automatically will create a configuration file the first time you
- run it. It will ask you questions whose answers will be stored in the
- file MSYST.DEF. If you ever want to change any of your selections, all
- you have to do is delete MSYST.DEF and run MSYST to go through the
- configuration procedure again. The following options are configurable:
- * Serial port address
- * Interrupt number
- * Serial port speed
- * Text background color
- * Text foreground color
- * CTS support (Turn it on unless it causes program to hang)
-
- Usage
- -----
-
- For the most part what ever you type at the keyboard is sent to your
- modem or TNC. The exceptions to this are the following keys:
- F1 - Gives brief help information
- F2 - Receive YAPP file after you tell BBS to send the file
- F3 - Send YAPP file after you tell BBS to receive the file
- F4 - Capture what appears on screen to a file
- F5 - Send an ASCII file as if typed
- F6 - End capture
- F9 - DOS Shell (use exit command to return to MSYST)
- Alt/X - Exit MSYST
-
- Arrow keys, Page Up or Down, Home, and End enter scroll back mode.
- To exit this mode, press Escape. F1 key (only F key that works when in
- scroll back mode) will give help summary. Alt/X will exit scroll mode and
- the program as well. While in scroll back mode incoming data is not
- displayed but is accumulated in the 16,000 byte input buffer. When you
- exit scroll back mode it will be displayed.
-
-
- Using YAPP Protocol to transfer files
- -------------------------------------
-
- Using YAPP is particularly easy when you are using a modem connection to
- MSYS. To download a file, type YD and the filename you want MSYS to send.
- Then press F2 and give the name you want the file to have on your system.
- You must complete this within 30 seconds of sending the YD command to MSYS.
- Next sit back and watch the file status be updated as the file is received.
-
- To upload a file using a modem, type YU and the name the file will have
- on the MSYS system. When MSYS says its ok to send your file (note that
- you have to be specifically enabled to upload files) press F3. Give the
- name of the file you want to send and wait for it to be sent.
-
- Using a TNC complicates things a bit because you have to switch your TNC
- into transparent mode for the actual data transfer. To receive a file,
- do the following:
- Type YD followed by the name of the file on MSYS you want
- When MSYS says to get ready to receive the file, type ^C to
- get back into your TNC's command mode
- Type the command for your tnc to get it into transparent mode
- (Usually TRANS)
- Press F2 and give the name you want the file to have on your system
- When the file transfer is complete, excape transparent mode
- (usually by typing ^C^C^C) to get back to your
- TNC's command mode.
- Now type the command to get your TNC in normal conversation
- mode (usually CONV or K)
-
- To send a file using a TNC, do the following:
- Type YU and the name the file is to have on the MSYS system
- When MSYS says its ok to send the file, type ^C to get to
- the TNC command mode.
- Get the TNC into transparent mode (see above)
- Press F3 and enter the name of the file on your system
- When the file transfer is complete, follow the instructions above
-
-
- If there is enough interest and support for this program it will be
- improved in the future. Possible enhancements could include VGA support,
- compressed data transmission and "smart" interaction with MSYS. And of
- course an improved documentation file. At this time I mainly want to
- provide a way to use the YAPP additions to MSYS over the phone (most
- of the other YAPP programs automate getting a TNC into transparent mode
- and thus can't easily be used with modems) and to test the waters to
- see what interest and support there may be for this program. Enjoy!